.\" Man page generated from reStructuredText.
.
.TH QUODLIBET 1 "" "" ""
.SH NAME
quodlibet \- audio library manager and player
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.nf
\fBquodlibet\fP [ \fB\-\-print\-playing\fP | \fIcontrol\fP ]
\fBexfalso\fP [ \fIdirectory\fP ]
.fi
.sp
.SH DESCRIPTION
.sp
Quod Libet is a music management program. It provides several different
ways to view your audio library, as well as support for Internet radio and
audio feeds. It has extremely flexible metadata tag editing and searching
capabilities.
.sp
This manual page is only a short reference for Quod Libet. Complete
documentation is available at
\fI\%https://quodlibet.readthedocs.io/en/latest/guide/index.html\fP\&.
.SH OPTIONS
.INDENT 0.0
.TP
.BI \-\-add\-location\fB= <location>
Add a file or directory to the library
.TP
.B \-\-debug
Print debugging information
.TP
.BI \-\-enqueue\fB= <filename|query>
Enqueue a filename or query results
.TP
.BI \-\-enqueue\-files\fB= <filename[,filename..]>
Enqueue comma\-separated files
.TP
.BI \-\-filter \ <tag=value>
Filter on a tag value
.TP
.B \-\-focus
Focus the running player
.TP
.B \-\-force\-previous
Jump to previous song
.TP
.B \-\-help
Display brief usage information
.TP
.B \-\-hide\-window
Hide main window
.TP
.B \-\-list\-browsers
List available browsers
.TP
.B \-\-next
Jump to next song
.TP
.B \-\-no\-plugins
Start without plugins
.TP
.BI \-\-open\-browser\fB= BrowserName
Open a new browser
.TP
.B \-\-pause
Pause playback
.TP
.B \-\-play
Start playback
.TP
.BI \-\-play\-file\fB= filename
Play a file
.TP
.B \-\-play\-pause
Toggle play/pause mode
.TP
.B \-\-previous
Jump to previous song if near the beginning, otherwise restart
.TP
.B \-\-print\-playing
Print out information about the currently playing song. You may
provide in a string like the kind described in the RENAMING FILES
section below.
.TP
.B \-\-print\-playlist
Print the current playlist
.TP
.BI \-\-print\-query\fB= <query>
Print filenames of results of query
.TP
.B \-\-print\-query\-text
Print the active text query
.TP
.B \-\-print\-queue
Print the contents of the queue
.TP
.BI \-\-query\fB= search\-string
Search your audio library
.TP
.BI \-\-queue\fB= <on|off|t>
Show or hide the queue
.TP
.B \-\-quit
Exit Quod Libet
.TP
.BI \-\-random\fB= tag
Filter on a random value
.TP
.BI \-\-rating\fB= <[+|\-]0.0..1.0>
Set rating of playing song
.TP
.B \-\-rating\-down
Decrease rating of playing song by one star
.TP
.B \-\-rating\-up
Increase rating of playing song by one star
.TP
.B \-\-refresh
Refresh and rescan library
.TP
.BI \-\-repeat\fB= <off|on|t>
Turn repeat off, on, or toggle
.TP
.BI \-\-repeat\-type\fB= <current|all|one|off>
Repeat the currently playing song, the current list, stop after
one song, or turn repeat off
.TP
.B \-\-run
Start Quod Libet if it isn\(aqt running
.TP
.BI \-\-seek\fB= <[+|\-][HH:]MM:SS>
Seek within the playing song
.TP
.BI \-\-set\-browser\fB= BrowserName
Set the current browser
.TP
.B \-\-show\-window
Show main window
.TP
.BI \-\-shuffle\fB= <off|on|t>
Turn shuffle off, on, or toggle
.TP
.BI \-\-shuffle\-type\fB= <random|weighted|off>
Set the shuffle type to be random, to prefer higher rated songs,
or turn shuffle off
.TP
.B \-\-start\-hidden
Don\(aqt show any windows on start
.TP
.B \-\-start\-playing
Begin playing immediately
.TP
.B \-\-status
Print playing status
.TP
.B \-\-stop
Stop playback
.TP
.BI \-\-stop\-after\fB= <0|1|t>
Stop after the playing song
.TP
.B \-\-toggle\-window
Toggle main window visibility
.TP
.B \-\-unfilter
Remove active browser filters
.TP
.BI \-\-unqueue\fB= <filename|query>
Unqueue a file or query
.TP
.B \-\-version
Display version and copyright
.TP
.BI \-\-volume\fB= <[+|\-]0..100>
Set the volume
.TP
.B \-\-volume\-down
Turn down the volume
.TP
.B \-\-volume\-up
Turn up the volume
.TP
.BI \-\-with\-pattern\fB= <pattern>
Set the output format of the --print-playing, --print-playlist,
--print-query, and --print-queue commands.  You may provide in a
tag-pattern string like the kind described in the RENAMING FILES
section below.
.UNINDENT
.SH ALBUM COVERS
.sp
Album covers should be put in the same directory as the songs they apply
to, and have "folder", "front", or "cover" in their filenames. If you want
to store multiple albums in the same directory but keep distinct cover
images, the name of the appropriate image file must contain the labelid tag
value, e.g. COCX\-32760 cover.jpg.
.SH TIED TAGS
.sp
Many places in Quod Libet allow you to use "tied tags". Tied tags are two
tag names joined together with a "~" like "title~version" or "album~part".
Tied tags result in "nice" displays even when one of the tags is missing;
for example, "title~version" will result in Title \- Version when a version
tag is present, but only Title when one isn\(aqt. You can tie any number of
tags together.
.SH SEARCH SYNTAX
.sp
All of Quod  Libet\(aqs search boxes support advanced searches of the
following forms:
.sp

.nf
tag = value
tag = !value
tag = "value"
tag = /value/
tag = &(value1, value2)
tag = |(value1, value2)
!tag = value
|(tag1 = value1, tag2 = value2)
&(tag1 = value1, tag2 = value2)
#(numerictag < value)
#(numerictag = value)
#(numerictag > value)
.fi
.sp
.sp

.sp
The \(aqc\(aq postfix on strings or regular expressions makes the  search
case\-sensitive. Numeric values may be given as integers, floating\-point
numbers, MM:SS format, or simple English, e.g. "3 days", "2 hours".
.sp
See \fI\%https://quodlibet.readthedocs.io/en/latest/guide/searching.html\fP\&.
.sp
All internal tags begin with a ~ character. Non\-numeric internal tags are
~base‐ name, ~dirname, ~filename, ~format, ~length, ~people, and ~rating.
Numeric internal tags are ~#added, ~#bitrate, ~#disc, ~#lastplayed,
~#laststarted, ~#length, ~#mtime, ~#playcount, ~#skipcount, and ~#track.
.sp
See \fI\%https://quodlibet.readthedocs.io/en/latest/guide/tags/internal_tags.html\fP\&.
.SH RENAMING FILES
.sp
Quod Libet allows you to rename files based on their tags. In some cases
you may wish to alter the filename depending on whether some tags are
present or missing, in addition to their values. A common pattern might be
.sp
\fB<tracknumber>. <title~version>\fP
.sp
You can use a \(aq|\(aq to only text when a tag is present:
.sp
\fB<tracknumber|<tracknumber>. ><title~version>\fP
.sp
You can also specify literal text to use if the tag is missing by adding another \(aq|\(aq:
.sp
\fB<album|<album>|No Album> \- <title>\fP
.sp
See \fI\%https://quodlibet.readthedocs.io/en/latest/guide/renaming_files.html\fP\&.
.SH AUDIO BACKENDS
.sp
Quod Libet uses GStreamer for audio playback. It tries to read your GConf
GStreamer configuration, but if that fails it falls back to osssink. You can
change the pipeline option in ~/.quodlibet/config to use a different sink, or
pass options to the sink. For example, you might use esdsink or alsasink
device=hw:1.
.sp
See \fI\%https://quodlibet.readthedocs.io/en/latest/guide/playback/backends.html\fP\&.
.SH FILES
.INDENT 0.0
.TP
.B ~/.quodlibet/songs
A pickled Python dict of cached metadata. Deleting this file will remove all
songs from your library.
.TP
.B ~/.quodlibet/config
Quod Libet\(aqs configuration file. This file is overwritten when Quod Libet
exits.
.TP
.B ~/.quodlibet/current
A "key=value" file containing information about the currently playing song.
.TP
.B ~/.quodlibet/control
A FIFO connected to the most\-recently\-started instance of the program.
\-\-next, \-\-previous, etc., use this to control the player.
.TP
.B ~/.quodlibet/plugins/
Put plugins here.
.TP
.B ~/.quodlibet/browsers/
Put custom library browsers here.
.UNINDENT
.sp
See \fI\%https://quodlibet.readthedocs.io/en/latest/guide/interacting.html\fP\&.
.SH BUGS
.sp
See \fI\%https://github.com/quodlibet/quodlibet/issues\fP for a list of all
currently open bugs and feature requests.
.SH AUTHORS
.sp
Joe Wreschnig and Michael Urman are the primary authors of Quod Libet.
.SH SEE ALSO
.nf
\fI\%https://quodlibet.readthedocs.io/en/latest/guide/\fP,
\fI\%https://quodlibet.readthedocs.io/en/latest/guide/faq.html\fP,
\fBregex\fP(7), \fBgst\-launch\fP(1)
.fi
.sp
.\" Generated by docutils manpage writer.
.
